home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / programmmanager / toolmanager / docs / tm_english.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  72KB  |  1,455 lines
  1. @database TM_English.guide
  2. @Master TM_English.tex
  3. @Width 72
  4. This is the AmigaGuide
  5.  file TM_English.guide, produced by Makeinfo-1.50 from 
  6. the input file TM_English.tex.
  7. @Node Main "TM_English.guide"
  8. @Next "Copyright"
  9. ToolManager 2.1 Documentation
  10. *****************************
  11. Chapters for @{i}all@{ui} users:
  12.  @{" Copyright " Link "Copyright"}                  Copyright and other legal stuff
  13.  @{" Important " Link "Important"}                  Important notes
  14.  @{" Authors address " Link "Authors address"}            Where to send bug reports, comments & donations
  15. Chapters for impatient users:
  16.  @{" Quick installation " Link "Quick installation"}         How to install ToolManager 2.1 the fast way
  17. Chapters for first-time users:
  18.  @{" Introduction " Link "Introduction"}               What is ToolManager?
  19.  @{" Concepts " Link "Concepts"}                   The concepts behind ToolManager
  20.  @{" Tutorial " Link "Tutorial"}                   A guided tour through ToolManager
  21.  @{" Distribution files " Link "Distribution files"}         Description of all files in the distribution
  22. Reference chapters:
  23.  @{" Objects " Link "Objects"}                    ToolManager objects reference
  24.  @{" Preferences " Link "Preferences"}                The ToolManager preferences editor
  25.  @{" Library " Link "Library"}                    The ToolManager shared library interface
  26.  @{" Hot Keys " Link "Hot Keys"}                   How to define a Hot Key
  27. Appendices:
  28.  @{" Questions " Link "Questions"}                  Most asked questions about ToolManager
  29.  @{" History " Link "History"}                    The history of ToolManager
  30.  @{" Credits " Link "Credits"}                    The author would like to thank...
  31.  @{" Index " Link "Index"}                      The Index for this document
  32. @EndNode
  33. @Node "Copyright" "TM_English.guide/Copyright"
  34. @Next "Important"
  35. @Prev "Main"
  36. @Toc "Main"
  37. Copyright and other legal stuff
  38. *******************************
  39.    Copyright (C) 1990-93 Stefan Becker
  40.    Permission is granted to make and distribute verbatim copies of this
  41. manual provided the copyright notice and this permission notice are
  42. preserved on all copies.
  43.    No guarantee of any kind is given that the programs described in
  44. this document are 100% reliable. You are using this material at your
  45. own risk. The author @{i}can not@{ui} be made responsible for any damage which
  46. is caused by using these programs.
  47.    This package is freely distributable, but still copyright by Stefan
  48. Becker. This means that you can copy it freely as long as you don't ask
  49. for a more than nominal copying fee. This fee @{i}must not@{ui} be more than US
  50. $5 or 5 DM.
  51.        @{i}This limit applies to German Public-Domain dealers too!!@{ui}
  52.    Permission is granted to include this package in Public-Domain
  53. collections, especially in Fred Fishs Amiga Disk Library (including CD
  54. ROM versions of it). The distribution file may be uploaded to Bulletin
  55. Board Systems or FTP servers. If you want to distribute this program
  56. you @{i}must@{ui} use the original distribution archives @{b}ToolManager2_1bin.lha@{ub},
  57. @{b}ToolManager2_1gfx.lha@{ub} and @{b}ToolManager2_1src.lha@{ub}.
  58.    None of the programs nor the source code (nor parts of it) may be
  59. included or used in commercial programs unless by written permission
  60. from the author.
  61.        @{i}None@{ui} of the programs @{i}nor@{ui} the source code (nor parts of it) may
  62. be used on any machine which is used for the research, development,
  63. construction, testing or production of weapons or other military
  64. applications. This also includes any machine which is used for training
  65. persons for @{i}any@{ui} of the above mentioned purposes.
  66. @EndNode
  67. @Node "Important" "TM_English.guide/Important"
  68. @Next "Authors address"
  69. @Prev "Copyright"
  70. @Toc "Main"
  71. Important notes
  72. ***************
  73.    Welcome to the wonderful world of ToolManager 2.1 :-)
  74.    - ToolManager and its concepts have drastically changed (see @{"History" Link "History"})
  75.      since the release 1.5.
  76.    - Starting with the ToolManager 2.0 release, this program has a
  77.      @{i}GiftWare@{ui} option. If you like the program and use it very often,
  78.      you should consider to send a little donation to honor the work
  79.      that the author has put into this program. I suggest a donation of
  80.      US $10-$20 or 10-20 DM. Please don't send cheques or money orders
  81.      from outside Europe, because most often cashing those items costs
  82.      more than what they amount to.
  83.      If you don't send the donation or can't afford it, you needn't
  84.      feel bad about it. Please send me a note saying that you are using
  85.      ToolManager anyway (I like to get fan mail :-). See
  86.      @{"Authors address" Link "Authors address"}.
  87.    - Users of ToolManager 1.X/2.0 can start with the quick installation
  88.      chapter (see @{"Quick installation" Link "Quick installation"}). Some features haven't changed
  89.      and the rest is fairly easy to find out by trial & error. For a
  90.      detailed description of the new concept & features browse the
  91.      reference part of this document (see @{"Objects" Link "Objects"}).
  92.      You @{i}must@{ui} remove any running ToolManager 1.X/2.0 or the new version
  93.      won't work. The new version cannot read the old 1.X configuration
  94.      file format (Sorry).
  95.    - First-time users should read the entire document to understand the
  96.      concept and purpose of the program. Start with @{"Introduction" Link "Introduction"}.
  97.    - ToolManager 2.1 uses some features of AmigaOS Release V38 (and
  98.      higher) and it supports the new AmigaOS networking features, which
  99.      will (hopefully) be available soon to all Amiga users. If you are
  100.      still using Release 2.0 (referred to as V37 in this document), you
  101.      need not worry since ToolManager doesn't rely on these features.
  102.      All extended features are marked in this documentation.
  103. @EndNode
  104. @Node "Authors address" "TM_English.guide/Authors address"
  105. @Next "Quick installation"
  106. @Prev "Important"
  107. @Toc "Main"
  108. Where to send bug reports, comments & donations
  109. ***********************************************
  110.    The author can be reached at the following addresses:
  111. Postal address:
  112.                Stefan Becker
  113.                Holsteinstrasse 9
  114.           5100 Aachen
  115.                GERMANY
  116.      Please use the following address after the 1-July-93:
  117.                 Stefan Becker
  118.                 Holsteinstrasse 9
  119.           52068 Aachen
  120.                 GERMANY
  121. InterNet Electronic Mail:
  122.           stefanb@pool.informatik.rwth-aachen.de
  123. @EndNode
  124. @Node "Quick installation" "TM_English.guide/Quick installation"
  125. @Next "Introduction"
  126. @Prev "Authors address"
  127. @Toc "Main"
  128. How to install ToolManager 2.1 the fast way
  129. *******************************************
  130.    The basic ToolManager 2.1 installation consists of the following
  131. four parts:
  132. @{b}Libs/toolmanager.library@{ub} => @{b}LIBS:@{ub}
  133.      This is the main program of ToolManager. It handles all programs,
  134.      menus, icons and docks (see @{"Library" Link "Library"}).
  135. @{b}Prefs/ToolManager*@{ub} => @{b}SYS:Prefs@{ub}
  136.      This is the editor for the configuration (see @{"Preferences" Link "Preferences"}).
  137. @{b}WBStartup/ToolManager*@{ub} => @{b}SYS:WBStartup@{ub}
  138.      With this utility you can start and stop ToolManager. If it
  139.      resides in the WBStartup drawer, ToolManager gets always loaded
  140.      when your machine boots up.
  141. @{b}L/WBStart-Handler@{ub} => @{b}L:@{ub}
  142.      This program starts programs by the Workbench startup method. It
  143.      is a seperate process, so that you can quit ToolManager even if
  144.      you have still programs running that were started by it with the
  145.      WB method.
  146.    After copying these files, you should quit any older version of
  147. ToolManager running on your machine and double-click the ToolManager
  148. icon in the @{b}WBStartup@{ub} drawer. Now you can start the preferences editor
  149. and play around (Use the "Test" button instead of the "Use" button
  150. while testing). You should be able to figure out most features with
  151. trial & error, for further information look into the ToolManager object
  152. descriptions (see @{"Objects" Link "Objects"}).
  153.    The distribution includes an example configuration file called
  154. @{b}TM_Demo.prefs@{ub}. You can load it into the preferences editor with the
  155. @{b}Open@{ub} menu item.
  156. @EndNode
  157. @Node "Introduction" "TM_English.guide/Introduction"
  158. @Next "Concepts"
  159. @Prev "Quick installation"
  160. @Toc "Main"
  161. What is ToolManager?
  162. ********************
  163.    ToolManager is a flexible program to manage the tools in your working
  164. environment. It can start Workbench and CLI programs, ARexx scripts and
  165. generate HotKey events. It even can issue commands to a ToolManager
  166. running on a remote machine. The user interface consists of menus,
  167. icons or dock windows. If you like a noisy computer, you can associate
  168. a sound to each of these items. See @{"Sound objects" Link "Sound"}.
  169.    ToolManager can add items to the Workbench @{b}Tools@{ub} menu. If you select
  170. such a menu item, the program associated with it will be started. Every
  171. selected icon on the Workbench will be used as an argument for the
  172. program. This feature is only available when the Workbench is running.
  173. See @{"Menu objects" Link "Menu"}.
  174.    ToolManager can add icons to the Workbench window. When you
  175. double-click such an icon, the program associated with it will be
  176. started. If you drop some icons on this icon, the program will be
  177. started with these icons as arguments. This feature is only available
  178. when the Workbench is running. See @{"Icon objects" Link "Icon"}.
  179.    ToolManager can create a dock window from a collection of programs.
  180. This window can be opened on every public screen. Each program is
  181. represented by an image or a button gadget. To start a program you
  182. simply click on the image or the button gadget. If the dock window has
  183. been opened on the Workbench screen and the Workbench is running, you
  184. can also drop some icons on the image or the button gadget to start the
  185. program with arguments. See @{"Dock objects" Link "Dock"}.
  186.    Additionally you can assign a Hot Key to each program. If you press
  187. this Hot Key, the program will be started. Note that @{i}no@{ui} arguments can be
  188. passed to the program if you use this startup method. See @{"Exec objects" Link "Exec"}.
  189. @EndNode
  190. @Node "Concepts" "TM_English.guide/Concepts"
  191. @Next "Tutorial"
  192. @Prev "Introduction"
  193. @Toc "Main"
  194. The concepts behind ToolManager
  195. *******************************
  196.    ToolManager 2.1 uses a new object-oriented approach to provide a
  197. flexible and extendable system. This approach made it possible to
  198. enhance several ToolManager features of the 1.X versions, e.g. you can
  199. now have multiple docks.
  200.    An object is a collection of data which describes its features. Each
  201. object has a name and a type. You can create as many objects of each
  202. type as you want, but the name of each object has to be unique, because
  203. it is used as a reference to this object.
  204.    Currently there are seven different types of objects: Exec, Image,
  205. Sound, Menu, Icon, Dock and Access. The first three of them are basic
  206. objects; that means they don't reference other objects. They provide
  207. data or services for the complex objects.
  208.    The last four object types are complex objects; that means they
  209. reference simple objects and rely on them to get access to data or
  210. services. The reference is done by name, and if no simple object with
  211. this name exists, the complex object will ignore it. Note that this may
  212. reduce the functionality of the complex object, e.g. an Icon object
  213. @{i}needs@{ui} the data from an Image object, so if this object doesn't exist it
  214. won't create an icon.
  215.    For a detailed description of all object parameters see @{"Objects" Link "Objects"}.
  216. @EndNode
  217. @Node "Tutorial" "TM_English.guide/Tutorial"
  218. @Next "Distribution files"
  219. @Prev "Concepts"
  220. @Toc "Main"
  221. A guided tour through ToolManager
  222. *********************************
  223.    So you haven't understood a word until now? Confused by objects,
  224. programs and links? Don't despair, help is on the way.
  225.    I will now guide you through a step-by-step example on how to
  226. configure ToolManager. All you need is to install ToolManager and to
  227. run the preferences editor. After each step, use the "Test" button in
  228. the main window to test the configuration.
  229.    As an example we use the text display program More in the drawer
  230. @{b}SYS:Utilities@{ub}. First we must tell ToolManager which program we want to
  231. use. Information about programs is stored in Exec objects. Just select
  232. "Exec" as object type in the main window of the preferences editor and
  233. press the "New" button.
  234.    After pressing the button you will see the "Edit Exec Object"
  235. window. Now open the Utilities drawer in your Workbench partition, move
  236. the More icon out of the drawer and drop it on the edit window. As you
  237. can see, the editor has now set the name of the object and the command
  238. to the program name, and the current directory to System:Utilities.
  239. Press the "OK" button to use the settings.
  240.    You can't do much with the Exec object alone, so as next step we
  241. want to add this program to the "Tools" menu of the Workbench. Select
  242. "Menu" as object type and press the "New" button. Now you will see the
  243. "Edit Menu Object" window. Change the name of the object to "Display
  244. Text".
  245.    ToolManager has to know which program it should start when the menu
  246. item is selected, so we link an Exec object to the menu object. Press
  247. the "Exec Object" button and select the object "More" from the
  248. requester. Now press "OK" button and the "Test" button in the main
  249. window. You can now see an entry in the "Tools" menu. Select a text
  250. file from the Workbench and choose the new menu entry. The program
  251. "More" should start and display the text. This is easy, isn't it?
  252.    Now we can go a step further and create an icon object on the
  253. Workbench. For an icon we need some image data, which is stored in an
  254. image object. Select "Image" as object type and press the "New" button.
  255. The "Edit Image Object" window will open. Change the name to "Image for
  256. More" and drop the More icon from the Utilities drawer on the window.
  257. Press "OK" to use the settings.
  258.    In the next step we will create the icon object. Select "Icon" as
  259. object type and press the "New" button. Change the name of the object
  260. to "Show Text". Press the "Exec object" button and select the object
  261. "More" from the requester. Press the "Image object" button and select
  262. the object "Image for More" from the requester. Set the X position to
  263. 100 and the Y position to 50. Press the "OK" button and the "Test"
  264. button. After a short delay an icon will appear on the Workbench, on
  265. which you can drop the icons of your text files to display them.
  266.    I'm sure you now have an idea how to use ToolManager objects and in
  267. which way you have to link them together to build your environment. Now
  268. you can figure out the rest of the features by trying them out one by
  269. one. You may also look at the demo configuration in the file
  270. @{b}TM_Demo.prefs@{ub}.
  271. @EndNode
  272. @Node "Distribution files" "TM_English.guide/Distribution files"
  273. @Next "Objects"
  274. @Prev "Tutorial"
  275. @Toc "Main"
  276. Description of all files in the distribution
  277. ********************************************
  278.    The complete ToolManager 2.1 distribution consists of several
  279. directories which are explained below. Note that the distribution is
  280. split up into three parts, so you may not have all directories which
  281. are mentioned below.
  282.  @{" Docs " Link "Docs"}              Documentation
  283.  @{" Goodies " Link "Goodies"}           Additional program packages
  284.  @{" Graphics " Link "Graphics"}          Anims, Brushes & Icons
  285.  @{" L " Link "L"}                 Support programs
  286.  @{" Libs " Link "Libs"}              ToolManager library
  287.  @{" Locale " Link "Locale"}            Localization support files
  288.  @{" Prefs " Link "Prefs"}             ToolManager preferences editor
  289.  @{" Programmers " Link "Programmers"}       Programmer support files
  290.  @{" Scripts " Link "Scripts"}           ARexx & Shell scripts
  291.  @{" Source " Link "Source"}            Complete source code for ToolManager 2.1
  292.  @{" WBStartup " Link "WBStartup"}         Utility programs
  293. @EndNode
  294. @Node "Docs" "TM_English.guide/Docs"
  295. @Next "Goodies"
  296. @Toc "Distribution files"
  297. The Docs directory
  298. ==================
  299.    This directory contains the documentation for ToolManager. The
  300. documentation is available in four different formats and several
  301. languages. Additionally there is a file in AutoDoc format describing
  302. the ToolManager shared library interface.
  303. Prefix @{b}TM_<language>@{ub}
  304.      This file contains the documentation for the specified language.
  305.      Currently available languages are: Deutsch, English, Fran
  306.      Svenska.
  307. Postfix @{b}.doc@{ub}
  308.      This file contains the documentation as plain ASCII text.
  309. Postfix @{b}.dvi@{ub}
  310.      This file contains the documentation in TeXs DVI format. To get a
  311.      printed manual, run this file through a TeX printer driver.
  312. Postfix @{b}.guide@{ub}
  313.      This file contains the documentation in AmigaGuide format.
  314.      Although it is only plain ASCII with some commands, you need
  315.      AmigaGuide to exploit the hypertext links in it.
  316. Postfix @{b}.tex@{ub}
  317.      This file contains the documentation in Texinfo format, as
  318.      specified by the Free Software Foundation (FSF). Together with the
  319.      @{b}texinfo.tex@{ub} macro package, you can use TeX and @{b}texindex@{ub} to create
  320.      a file in DVI format (see above).
  321. @{b}toolmanager.doc@{ub}
  322.      This file contains the ToolManager shared library interface
  323.      description in AutoDoc format.
  324. @EndNode
  325. @Node "Goodies" "TM_English.guide/Goodies"
  326. @Next "Graphics"
  327. @Prev "Docs"
  328. @Toc "Distribution files"
  329. The Goodies directory
  330. =====================
  331.    This directory contains additional program packages which are useful
  332. for ToolManagers operation.
  333. @{b}GetPubName.lha@{ub}
  334.      This little program prints the name of the frontmost public screen
  335.      either to stdout or into an environment variable. It was written
  336.      by Michael "Mick" Hohmann.
  337. @{b}upd1_20.lha@{ub}
  338.      The program @{b}upd@{ub} was written by Jonas Petersson. It is a small
  339.      program which opens an ARexx port and waits for commands. Via
  340.      ARexx you can order @{b}upd@{ub} to play sampled files. ToolManager uses
  341.      this feature to implement its Sound objects. See @{"Sound objects" Link "Sound"}.
  342. @EndNode
  343. @Node "Graphics" "TM_English.guide/Graphics"
  344. @Next "L"
  345. @Prev "Goodies"
  346. @Toc "Distribution files"
  347. The Graphics directory
  348. ======================
  349.    This directory contains a rich collection of images from which you
  350. can choose your favourite ones. Just load them as Image objects into
  351. ToolManager (see @{"Image objects" Link "Image"}).
  352.    The files were contributed by various people (see @{"Credits" Link "Credits"}). Each of
  353. them got a seperate sub-directory in the distribution. As the files were
  354. created by different authors, they come from different environments
  355. (palette, depth, resolution, size) and have different design styles. So
  356. not all images may look good on your machine.
  357.    To differentiate the image formats that are supported by
  358. ToolManager, each file has a postfix which describes the file format:
  359. @{b}.anmb@{ub}
  360.      This is an IFF ANIM file created by a paint/animation program. It
  361.      can contain several pictures. Although ToolManager can load
  362.      complete ANIM files, you must use something like DPaints
  363.      "AnimBrush" feature to cut out the interesting part of the
  364.      animation.
  365. @{b}.brush@{ub}
  366.      This is an IFF ILBM file created by a paint program. It contains
  367.      only one image.
  368. @{b}.info@{ub}
  369.      This is a normal Amiga Icon created with IconEdit (or something
  370.      similiar). It can contain two images.
  371. @EndNode
  372. @Node "L" "TM_English.guide/L"
  373. @Next "Libs"
  374. @Prev "Graphics"
  375. @Toc "Distribution files"
  376. The L directory
  377. ===============
  378.    This directory contains only one file, namely @{b}WBStart-Handler@{ub}. You
  379. @{i}must@{ui} copy this file to the @{b}L:@{ub} directory, or otherwise ToolManager won't
  380. be able to start any Exec objects by the WB startup method (see
  381. @{"Exec objects" Link "Exec"}).
  382.    The complete package WBStart 1.2 may be found on Fish Disk #757.
  383. @EndNode
  384. @Node "Libs" "TM_English.guide/Libs"
  385. @Next "Locale"
  386. @Prev "L"
  387. @Toc "Distribution files"
  388. The Libs directory
  389. ==================
  390.    This directory contains only one file, @{b}toolmanager.library@{ub}. This is
  391. the main program for ToolManager and must be copied to the @{b}LIBS:@{ub}
  392. directory.
  393. @EndNode
  394. @Node "Locale" "TM_English.guide/Locale"
  395. @Next "Prefs"
  396. @Prev "Libs"
  397. @Toc "Distribution files"
  398. The Locale directory
  399. ====================
  400.    This directory contains all files for ToolManagers Locale support. As
  401. locale.library is new with V38, you need not copy these files if you are
  402. using V37. If you are using V38, choose the files for your language and
  403. copy them to the appropriate places.
  404. @{b}Catalogs/<language>/toolmanager.catalog@{ub}
  405.      This is a translation file for the specified language. Copy the
  406.      file for your language to the directory @{b}LOCALE:Catalogs/<language>@{ub}.
  407. @{b}Languages/<language>.language@{ub}
  408.      Some languages are not supported by the standard V38 Locale
  409.      distribution. So some of the translators have supplied a @{b}.language@{ub}
  410.      file, so that ToolManager can use their translation files. Copy
  411.      the file for your language to the directory @{b}LOCALE:Languages@{ub}.
  412.      Additional available languages are: Finnish (suomi), Eefeler Platt
  413.      (eifel).
  414. @EndNode
  415. @Node "Prefs" "TM_English.guide/Prefs"
  416. @Next "Programmers"
  417. @Prev "Locale"
  418. @Toc "Distribution files"
  419. The Prefs directory
  420. ===================
  421.    The ToolManager preferences editor and its icon reside in this
  422. directory. Copy both files to the directory @{b}SYS:Prefs@{ub}. For further
  423. information on the editor see @{"Preferences" Link "Preferences"}.
  424. @EndNode
  425. @Node "Programmers" "TM_English.guide/Programmers"
  426. @Next "Scripts"
  427. @Prev "Prefs"
  428. @Toc "Distribution files"
  429. The Programmers directory
  430. =========================
  431.    This directory contains all files which are needed by the various
  432. computer languages and their compilers to use the ToolManager shared
  433. library interface. Look into the sub-directory @{b}examples@{ub} for some
  434. examples on how to use this interface. For a complete interface
  435. description read the file @{b}Docs/toolmanager.doc@{ub}.
  436.    Currently supported languages/compilers are: AmigaOberon, DICE C,
  437. M2Amiga Modula-2, MANX Aztec C and SAS C.
  438. @EndNode
  439. @Node "Scripts" "TM_English.guide/Scripts"
  440. @Next "Source"
  441. @Prev "Programmers"
  442. @Toc "Distribution files"
  443. The Scripts directory
  444. =====================
  445.    This directory contains a collection of ARexx or Shell scripts which
  446. can be used in ToolManagers Exec objects. Note that they may be
  447. specific to the authors environment or shell, so you may have to modify
  448. them.
  449. @EndNode
  450. @Node "Source" "TM_English.guide/Source"
  451. @Next "WBStartup"
  452. @Prev "Scripts"
  453. @Toc "Distribution files"
  454. The Source directory
  455. ====================
  456.    This directory contains the complete source code to ToolManager 2.1
  457. and its utilities. Each program has its own sub-directory. The author
  458. provides the source code as an example for OS 2.x/3.0 programming.
  459.    The @{b}locale@{ub} sub-directory is of interest for translators. If your
  460. language is not supported in this release and you want to do the
  461. translation, look at the file @{b}empty.ct@{ub}. Just fill in the empty lines
  462. and send the file to me. Maybe it will be included in the next release.
  463. @EndNode
  464. @Node "WBStartup" "TM_English.guide/WBStartup"
  465. @Prev "Source"
  466. @Toc "Distribution files"
  467. The WBStartup directory
  468. =======================
  469.    Only one program resides in this directory: @{b}ToolManager@{ub}. This utility
  470. starts and stops ToolManager 2.1. Most of the time this utility will
  471. reside in the @{b}SYS:WBStartup@{ub} directory, but it can be used from the
  472. Shell too.
  473. @EndNode
  474. @Node "Objects" "TM_English.guide/Objects"
  475. @Next "Preferences"
  476. @Prev "Distribution files"
  477. @Toc "Main"
  478. ToolManager objects reference
  479. *****************************
  480.    This chapter describes the ToolManager objects in detail. Each
  481. object has a type and a name. The name is used to reference the object.
  482. There are six different types of objects:
  483.  @{" Exec " Link "Exec"}        Exec objects
  484.  @{" Image " Link "Image"}       Image objects
  485.  @{" Sound " Link "Sound"}       Sound objects
  486.  @{" Menu " Link "Menu"}        Menu objects
  487.  @{" Icon " Link "Icon"}        Icon objects
  488.  @{" Dock " Link "Dock"}        Dock objects
  489.  @{" Access " Link "Access"}      Access objects
  490. @EndNode
  491. @Node "Exec" "TM_English.guide/Exec"
  492. @Next "Image"
  493. @Toc "Objects"
  494. Exec objects
  495. ============
  496.    Exec objects describe programs or actions which are started by
  497. ToolManager. Three different types of programs are supported: CLI,
  498. Workbench and ARexx. Three different types of actions are supported:
  499. Dock, Hot Key, Network. Each Exec object has the following parameters.
  500. The defaults are set in parantheses:
  501. @{b}Arguments@{ub} (Yes)
  502.      This switch controls the handing over of arguments to the program.
  503.      If a program doesn't support arguments or doesn't need them, you
  504.      can switch off the argument passing.
  505. @{b}Command@{ub}
  506.      The file name of the program or action to start. This name may be
  507.      relative to the current directory. If the type is Dock, the
  508.      command describes the name of the dock object, which should be
  509.      opened/closed. For the type Hot Key this string must be a
  510.      Commodities Input Description String (see @{"Hot Keys" Link "Hot Keys"}). A remote
  511.      command (type Network) is described as @{b}object@machine@{ub}, which tells
  512.      the ToolManager running on @{b}machine@{ub} to activate the Exec object
  513.      named @{b}object@{ub}.
  514. @{b}Current Directory@{ub} (@{b}SYS:@{ub})
  515.      The name of the current directory for the program. Note: ARexx
  516.      programs ignore this parameter.
  517. @{b}Delay@{ub} (0)
  518.      After activation of an Exec object, ToolManager waits @{b}Delay@{ub} seconds
  519.      before it starts the program. If this value is negative, the
  520.      program will be started every @{b}Delay@{ub} seconds. To stop an Exec
  521.      object which is waiting for execution, just activate it again.
  522.      Note: If @{b}Delay@{ub} is set, the program will be started without
  523.      arguments.
  524. @{b}Exec Type@{ub} (CLI)
  525.      This specifies the type of the program or action. It can be one
  526.      of: CLI, WB, ARexx, Dock, Hot Key or Network.
  527. @{b}Hot Key@{ub}
  528.      You can set a Hot Key for each Exec object. If this Hot Key event
  529.      is generated, the program will be started. Note: The program will
  530.      be started with no arguments.
  531. @{b}Output File@{ub} (@{b}NIL:@{ub})
  532.      This is the file name of the output file. This is only useful for
  533.      CLI programs.
  534. @{b}Path@{ub} (path from ToolManager process)
  535.      This string sets the command search path for the program. You can
  536.      specify several directories by seperating the names with a ";".
  537.      This is only useful for CLI programs.
  538. @{b}Priority@{ub} (0)
  539.      This sets the priority of the new process which runs the program.
  540. @{b}Public Screen@{ub} (default public screen)
  541.      You can set the name of the public screen which should be moved to
  542.      front before the program is started. This only works in
  543.      conjunction with the @{b}To Front@{ub} parameter.
  544. @{b}Stack@{ub} (4096)
  545.      This sets the stack size of the new process which runs the program.
  546. @{b}To Front@{ub} (No)
  547.      If you set this parameter the public screen specified by @{b}Public
  548.      Screen@{ub} is moved to front before the program is started.
  549. @EndNode
  550. @Node "Image" "TM_English.guide/Image"
  551. @Next "Sound"
  552. @Prev "Exec"
  553. @Toc "Objects"
  554. Image objects
  555. =============
  556.    Image objects specify the image data which is used by ToolManager
  557. for icons or docks. This object type has only one parameter:
  558. @{b}File Name@{ub}
  559.      This specifies the name of the file from which ToolManager should
  560.      read the image data. ToolManager tries to detect the type of image
  561.      data automatically:
  562.        1. It tries to load it as IFF data. Currently ToolManager can
  563.           read ILBM (one image) or ANIM (two or more images) files.
  564.        2. It tries to read in an icon file. An icon can have one or two
  565.           images.
  566.    Animations are currently only supported by Dock objects. Icon
  567. objects only retrieve the first and the second image from the animation
  568. to build a two image icon. If you want to make an animation for
  569. ToolManager, you should follow these design rules:
  570. Image 1
  571.      This should be an image which represents the inactive state.
  572. Image 2
  573.      This should be an image which represents the selected state.
  574.      Normally this is an inverted copy of the first image.
  575. Image 3 to N-1
  576.      These are the images for the animation. Each image will be shown
  577.      for 1/3 of a second.
  578. Image N
  579.      The last picture of the animation will be shown one second. After
  580.      this the first picture will be shown again.
  581. @EndNode
  582. @Node "Sound" "TM_English.guide/Sound"
  583. @Next "Menu"
  584. @Prev "Image"
  585. @Toc "Objects"
  586. Sound objects
  587. =============
  588.    A Sound object can be used to make ToolManager noisy. ToolManager
  589. itself has no ability builtin to play sound data, it uses ARexx to
  590. activate an external sound player daemon. This object type has two
  591. parameters:
  592. @{b}Command@{ub}
  593.      This sets the ARexx command which ToolManager sends to activate
  594.      the external sound player. For @{b}upd@{ub} this could be something like
  595.      @{b}file samples:boing@{ub} which instructs @{b}upd@{ub} to play the IFF sample
  596.      @{b}samples:boing@{ub}. See @{"Goodies" Link "Goodies"}.
  597. @{b}ARexx Port@{ub}
  598.      This specifies the ARexx port where ToolManager should send
  599.      @{b}command@{ub} to. The default is @{b}PLAY@{ub} which is the port for the
  600.      program @{b}upd@{ub}.
  601. @EndNode
  602. @Node "Menu" "TM_English.guide/Menu"
  603. @Next "Icon"
  604. @Prev "Sound"
  605. @Toc "Objects"
  606. Menu objects
  607. ============
  608.    Menu objects control the entries in the Workbench Tools menu. The
  609. object name is used as the menu text. To activate such an object, just
  610. select the menu entry. Menu objects only work when the Workbench is
  611. running.
  612.    This object type has two parameters:
  613. @{b}Exec Object@{ub}
  614.      This is the name of an Exec object which should be activated when
  615.      the menu entry is selected. Every icon which is selected at this
  616.      time will be used as an argument for the program.
  617. @{b}Sound Object@{ub}
  618.      This is the name of a Sound object which should be activated when
  619.      the menu entry is selected.
  620.    Note to ToolManager 1.X users: To simulate the old tool type "Dummy"
  621. just create a Menu object and specify @{i}no@{ui} Exec and Sound object.
  622. @EndNode
  623. @Node "Icon" "TM_English.guide/Icon"
  624. @Next "Dock"
  625. @Prev "Menu"
  626. @Toc "Objects"
  627. Icon objects
  628. ============
  629.    Icon objects describe application icons in the Workbench window.
  630. Such an object can be activated by double-clicking the icon or by
  631. dropping some icons on the application icon. Icon objects only work
  632. when the Workbench is running.
  633.    The parameters for this object type are as follows:
  634. @{b}Exec Object@{ub}
  635.      This is the name of an Exec object which should be activated when
  636.      the icon is selected. Every icon which is dropped on the
  637.      application icon will be used as an argument for the program.
  638. @{b}Image Object@{ub}
  639.      This is the name of an Image object. The image data of this object
  640.      is used to build the application icon.
  641. @{b}Left Edge@{ub} (default: 0)
  642.      This sets the left edge for the application icon.
  643. @{b}Show Name@{ub} (default: Yes)
  644.      If this parameter is set, the object name will be used as the name
  645.      for the application icon.
  646. @{b}Sound Object@{ub}
  647.      This is the name of a Sound object which should be activated when
  648.      the icon is selected.
  649. @{b}Top Edge@{ub} (default: 0)
  650.      This sets the top edge for the application icon.
  651.    Note: The Workbench is @{i}very@{ui} picky about the position of icons. If you
  652. specify coordinates which the Workbench doesn't like, it will ignore
  653. them and place the icon somewhere else.
  654. @EndNode
  655. @Node "Dock" "TM_English.guide/Dock"
  656. @Next "Access"
  657. @Prev "Icon"
  658. @Toc "Objects"
  659. Dock objects
  660. ============
  661.    Dock objects describe windows. These windows combine several tools
  662. which are represented by images or gadgets. To start such a tool just
  663. click on its image or gadget. Of course you can drop some icons on the
  664. image or gadget to supply arguments for the tool.
  665.    Each dock object has several parameters. The defaults are set in
  666. parentheses:
  667. @{b}Activated@{ub} (Yes)
  668.      A dock window can be active (open) or not (closed).
  669. @{b}Backdrop@{ub} (No)
  670.      This tells the dock window to go immediately to the back after
  671.      opening.
  672. @{b}Centered@{ub} (No)
  673.      If this parameter is set, the window will always be centered to
  674.      the current mouse position when it opens.
  675. @{b}Columns@{ub} (1)
  676.      This parameter sets the the number of tool columns. Tools are
  677.      always sorted row-wise, starting at the leftmost column and
  678.      filling up to the rightmost column.
  679. @{b}Font@{ub} (Screen font)
  680.      If you have a dock window with the parameter @{b}Text@{ub} set, you can
  681.      choose the font for the button gadgets with this parameter.
  682. @{b}Frontmost@{ub} (No)
  683.      If you set this parameter, the dock window will always open on the
  684.      frontmost public screen.
  685. @{b}Hot Key@{ub}
  686.      You can set a Hot Key for each Dock object. If this Hot Key event
  687.      is generated, the activation status of the dock window will be
  688.      toggled; that is it will be closed or opened.
  689. @{b}Left Edge@{ub} (0)
  690.      This parameter sets the left edge of the dock window. If the
  691.      parameter @{b}Centered@{ub} is set, this parameter will be ignored.
  692. @{b}Menu@{ub} (No)
  693.      You can add a small menu to each dock window. This menu has two
  694.      items:
  695.         @{b}*@{ub}     @{b}Close Dock@{ub} Close dock window.
  696.         @{b}*@{ub}     @{b}Quit TM@{ub} Quit ToolManager
  697. @{b}Pattern@{ub} (No)
  698.      The dock window automatically adjusts its size to the largest
  699.      image. Each dock entry has the same size, and smaller images are
  700.      centered, so they have a blank border around them. If you don't
  701.      like this blank border, set this parameter and the border will be
  702.      filled with a pattern.
  703. @{b}PopUp@{ub} (No)
  704.      When this parameter is set the dock window will be closed
  705.      automatically after selecting one dock entry. This is especially
  706.      useful in conjunction with the parameters @{b}Centered@{ub}, @{b}Frontmost@{ub} and
  707.      a Hot Key of the class @{b}rawmouse@{ub} (see @{"Hot Keys" Link "Hot Keys"}).
  708. @{b}Public Screen@{ub} (Default public screen)
  709.      Specifies the public screen on which the dock window should open.
  710.      If the dock window was opened via Hot Key, the public screen will
  711.      be moved to front after the window has been opened. This parameter
  712.      will be ignored if the parameter @{b}Frontmost@{ub} is set.
  713. @{b}Sticky@{ub} (No)
  714.      Normally a dock window stores its last position when you close it
  715.      and pops up at the same position when you re-open it. If you want
  716.      the dock window to open always at the same position, you must set
  717.      this parameter.
  718. @{b}Text@{ub} (No)
  719.      You can choose between images and button gadgets in dock windows
  720.      with this parameter. Button dock windows are especially useful
  721.      when used in conjunction with the parameter @{b}PopUp@{ub}.
  722. @{b}Title@{ub}
  723.      This specifies the dock window title. If you supply a title, the
  724.      dock window will be a normal OS 2.0 window with dragbar, close
  725.      gadget, depth gadget and a border. If you @{i}don't@{ui} supply a title,
  726.      you will get a dock window with only a dragbar and @{i}no@{ui} border.
  727. @{b}Top Edge@{ub} (0)
  728.      This parameter sets the top edge of the dock window. If the
  729.      parameter @{b}Centered@{ub} is set, this parameter will be ignored.
  730. @{b}Vertical@{ub} (No)
  731.      If the dock window has the new window design (that is: only a
  732.      dragbar and no border), this parameter sets the orientation of the
  733.      dragbar. This parameter is ignored if you supplied a window title
  734.      with the parameter @{b}Title@{ub}.
  735. @EndNode
  736. @Node "Access" "TM_English.guide/Access"
  737. @Prev "Dock"
  738. @Toc "Objects"
  739. Access objects
  740. ==============
  741.    Access objects control the access rights for network requests. Per
  742. default @{i}every@{ui} request is denied, so a remote ToolManager can't harm the
  743. operation of your machine by activating some of your Exec objects. With
  744. Access objects you can allow specific machines to activate some of your
  745. Exec objects.
  746.    The name of an Access object has a special meaning. It is matched
  747. with the name of the remote machine from which a network request was
  748. sent. ToolManager uses the following three step matching scheme:
  749.   1. Match with the complete host name
  750.   2. Match with the realm name
  751.   3. Look for the Access object named @{b}anyone@{ub}
  752.    If a corresponding object is found, then this object is used for the
  753. access rights of the remote machine. The object named @{b}anyone@{ub} is used
  754. for any network request, for which a corresponding Access object can't
  755. be found.
  756.    The Access object type has only one parameter:
  757. @{b}Exec Object@{ub}
  758.      This parameter can be used several times and specifies which Exec
  759.      objects can be activated from the remote machine. If you don't
  760.      specify @{i}any@{ui} object name, then the remote machine can activate @{i}all@{ui}
  761.      Exec objects on your machine.
  762. @EndNode
  763. @Node "Preferences" "TM_English.guide/Preferences"
  764. @Next "Library"
  765. @Prev "Objects"
  766. @Toc "Main"
  767. The ToolManager preferences editor
  768. **********************************
  769.    With the preferences editor you can manage the global configuration
  770. of ToolManager. This configuration gets automatically loaded when you
  771. start ToolManager. To start the editor just double click its icon. You
  772. will then see the main window.
  773.    Most of the gadgets in the editor windows have keyboard shortcuts.
  774. They are marked with an underscore (@{b}_@{ub}). Note that if a string gadget is
  775. active, you must first press the return key before you can use the
  776. keyboard shortcuts.
  777.  @{" Main Window Gadgets " Link "Main Window Gadgets"} 
  778.  @{" Main Window Menus " Link "Main Window Menus"} 
  779.  @{" Create Objects Window " Link "Create Objects Window"} 
  780.  @{" Edit Windows " Link "Edit Windows"} 
  781.  @{" Tooltypes " Link "Tooltypes"} 
  782.  @{" CLI Arguments " Link "CLI Arguments"} 
  783. @EndNode
  784. @Node "Main Window Gadgets" "TM_English.guide/Main Window Gadgets"
  785. @Next "Main Window Menus"
  786. @Toc "Preferences"
  787. Main window gadgets
  788. ===================
  789.    The main window has several groups of gadgets:
  790. Object type
  791.      With this cycle gadget you can choose the type of objects that you
  792.      want to create or edit.
  793. Object list
  794.      This gadget shows the list of all objects of the current type. You
  795.      can select an object by clicking on its name. If you double-click
  796.      one item, an edit window will open.
  797. Move object
  798.      When an object is selected, you can move it around in the list
  799.      with these gadgets. If you click on the @{b}Sort@{ub} gadget, the items in
  800.      the list will be sorted alphabetically.
  801. Manipulate object
  802.      These gadgets manipulate objects. The @{b}New@{ub} gadget creates a new
  803.      object of the current type which is selected automatically. When
  804.      you click on the @{b}Edit@{ub} gadget, an edit window for the selected
  805.      object will open. With the @{b}Copy@{ub} gadget you can make a copy of the
  806.      selected object. The @{b}Remove@{ub} gadget deletes the selected object.
  807. Configuration
  808.      You have several choices to save the configuration. With the @{b}Save@{ub}
  809.      gadget you can save the configuration permanently into the file
  810.      @{b}ENVARC:ToolManager.prefs@{ub}. For a temporary change use the @{b}Use@{ub}
  811.      gadget, which will save the configuration into the file
  812.      @{b}ENV:ToolManager.prefs@{ub}. This file will not survive a machine reset.
  813.      To test the new configuration without leaving the editor, use the
  814.      @{b}Test@{ub} gadget. The @{b}Cancel@{ub} gadget will quit the editor without saving.
  815. @EndNode
  816. @Node "Main Window Menus" "TM_English.guide/Main Window Menus"
  817. @Next "Create Objects Window"
  818. @Prev "Main Window Gadgets"
  819. @Toc "Preferences"
  820. Main window menus
  821. =================
  822.    The main window has several menu items:
  823. @{b}Project@{ub}
  824.      With the menu items @{b}Open@{ub} and @{b}Save As@{ub} you can load and save the
  825.      configuration. The @{b}About@{ub} item opens an information requester.
  826.      Selecting the @{b}Quit@{ub} item will leave the editor without saving.
  827. @{b}Edit@{ub}
  828.      With these menu items you can restore older configurations. The
  829.      @{b}Last Saved@{ub} item loads the last saved configuration from the file
  830.      @{b}ENVARC:ToolManager.prefs@{ub}. With the item @{b}Restore@{ub} you can load the
  831.      configuration that was active before you started the editor from
  832.      the file @{b}ENV:ToolManager.prefs@{ub}.
  833. @{b}Settings@{ub}
  834.      You can choose with the @{b}Create Icons@{ub} item wether the menu item
  835.      @{b}Save As@{ub} should create an icon or not.
  836. @EndNode
  837. @Node "Create Objects Window" "TM_English.guide/Create Objects Window"
  838. @Next "Edit Windows"
  839. @Prev "Main Window Menus"
  840. @Toc "Preferences"
  841. Create objects window
  842. =====================
  843.    If you drop an icon on the main window, the "Create objects" window
  844. will open. Here you can choose what objects should be created from this
  845. icon. This can be used to add a program to your configuration very
  846. easily and fast.
  847.    You can just create an Exec or Image object from the icon, if you
  848. select one of the first two choices. But you can also create a complete
  849. Menu and/or Icon object if you select one of the last three choices.
  850. @EndNode
  851. @Node "Edit Windows" "TM_English.guide/Edit Windows"
  852. @Next "Tooltypes"
  853. @Prev "Create Objects Window"
  854. @Toc "Preferences"
  855. Edit windows
  856. ============
  857.    Each object type has a different edit window to set the object
  858. parameters. For a detailed list of all object parameters see @{"Objects" Link "Objects"}.
  859.    Every edit window has a string gadget for the object name. This name
  860. is important, because it is used to reference this object. Note that
  861. there is currently no builtin cross-reference. So if you change the
  862. name of an object which is already referenced by another object, this
  863. reference will @{i}not@{ui} be updated. You have to update this reference by
  864. hand.
  865.    The button gadgets in the edit windows open different types of
  866. requesters. You can choose an item by clicking on it and pressing the
  867. @{b}OK@{ub} gadget, or you simply double-click it. To leave a requester
  868. without changes, use the @{b}Cancel@{ub} gadget. If you wish to clear a field
  869. which can only be choosen by a requester, open the requester and press
  870. the @{b}OK@{ub} gadget @{i}without@{ui} selecting an item.
  871.    The edit windows for the object types Exec and Image have an
  872. additional feature. You can simply drop an icon on them to set the
  873. parameters from this icon.
  874. @EndNode
  875. @Node "Tooltypes" "TM_English.guide/Tooltypes"
  876. @Next "CLI Arguments"
  877. @Prev "Edit Windows"
  878. @Toc "Preferences"
  879. Tooltypes
  880. =========
  881.    When you start the preferences editor from the Workbench you can set
  882. several tooltypes in the program icon or configuration file icons to
  883. control it.
  884. @{b}USE@{ub}
  885.      If you set this tooltype in an icon for a preferences file, the
  886.      editor will install this file as current configuration file.
  887. @{b}SAVE@{ub}
  888.      If you set this tooltype in an icon for a preferences file, the
  889.      editor will install this file as current and as permanent
  890.      configuration file.
  891. @{b}PUBSCREEN@{ub}
  892.      This tooltype tells the editor to open its windows on a specific
  893.      public screen. If you don't supply this tooltype, the default
  894.      public screen will be used.
  895. @{b}CREATEICONS@{ub}
  896.      When this tooltype is set to @{b}YES@{ub}, the editor will create an icon
  897.      for every preferences file that is created with the @{b}Save As@{ub} menu
  898.      item.
  899. @{b}DEFAULTFONT@{ub}
  900.      The editor normally uses the public screen font to draw its
  901.      gadgets. If you set this tooltype to @{b}YES@{ub}, the editor will use the
  902.      system default font instead.
  903. @{b}XPOS@{ub}
  904.      This specifies the initial X position of the editor main window.
  905. @{b}YPOS@{ub}
  906.      This specifies the initial Y position of the editor main window.
  907. @{b}MINLISTCOLUMNS@{ub}
  908.      This specifies the minimum number of columns in the list gadgets.
  909. @{b}MINLISTROWS@{ub}
  910.      This specifies the minimum number of rows in the list gadgets.
  911. @EndNode
  912. @Node "CLI Arguments" "TM_English.guide/CLI Arguments"
  913. @Prev "Tooltypes"
  914. @Toc "Preferences"
  915. CLI Arguments
  916. =============
  917.    When the preferences editor is started from the shell, it uses the
  918. following command line template:
  919.      FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,DEFAULTFONT/S
  920. @{b}FROM@{ub}
  921.      This parameter specifies the name of the preferences file which
  922.      the editor should load.
  923. @{b}USE@{ub}
  924.      If you use this parameter, the editor will install the file
  925.      specified as the @{b}FROM@{ub} parameter as current configuration file.
  926. @{b}SAVE@{ub}
  927.      If you use this parameter, the editor will install the file
  928.      specified as the @{b}FROM@{ub} parameter as current and as permanent
  929.      configuration file.
  930. @{b}PUBSCREEN@{ub}
  931.      This parameter tells the editor to open its windows on a specific
  932.      public screen. If you don't supply this tooltype the default
  933.      public screen will be used.
  934. @{b}DEFAULTFONT@{ub}
  935.      The editor normally uses the public screen font to draw its
  936.      gadgets. If you use this parameter the editor will use the system
  937.      default font instead.
  938. @EndNode
  939. @Node "Library" "TM_English.guide/Library"
  940. @Next "Hot Keys"
  941. @Prev "Preferences"
  942. @Toc "Main"
  943. The ToolManager shared library interface
  944. ****************************************
  945.    The ToolManager handler is embedded into a Amiga shared library.
  946. This library offers several functions to create and manipulate
  947. ToolManager objects, so that you can use them in your programs.
  948.    There are currently six functions available:
  949. @{b}AllocTMHandle()@{ub}
  950.      In order to create ToolManager objects you must first allocate a
  951.      TMHandle. This handle stores all information about your objects
  952.      and is used to reference them. Note that the information stored in
  953.      this handle is @{i}only@{ui} accessable by the program which creates it.
  954. @{b}FreeTMHandle()@{ub}
  955.      This function frees a TMHandle and all ToolManager objects
  956.      associated with it. Each @{b}AllocTMHandle()@{ub} must be matched with a
  957.      @{b}FreeTMHandle()@{ub}!
  958. @{b}CreateTMObjectTags()@{ub}
  959. @{b}CreateTMObjectTagList()@{ub}
  960.      This function creates a ToolManager object. You must supply a
  961.      name, the object type and various tags for the object parameters.
  962.      The name of the object is important, as it is used to reference
  963.      the object.
  964. @{b}ChangeTMObjectTags()@{ub}
  965. @{b}ChangeTMObjectTagList()@{ub}
  966.      You can modify the parameters of a ToolManager object with this
  967.      function. The object state will be updated to reflect the new
  968.      parameters. Note: Currently Image objects can't be modified.
  969. @{b}DeleteTMObject()@{ub}
  970.      With this function you can delete a ToolManager object. If the
  971.      object is linked to other objects, these objects will be notified
  972.      to update their state.
  973. @{b}QuitToolManager()@{ub}
  974.      This function tells the ToolManager handler to quit as soon as
  975.      possible.
  976.    The complete library interface description is available in AutoDoc
  977. format (see @{"Documentation" Link "Docs"}).
  978. @EndNode
  979. @Node "Hot Keys" "TM_English.guide/Hot Keys"
  980. @Next "Questions"
  981. @Prev "Library"
  982. @Toc "Main"
  983. How to define a Hot Key
  984. ***********************
  985.    This chapter describes how to define a Hot Key as an Input
  986. Description String, which is then parsed by Commodities. Each time a
  987. Hot Key is activated Commodities generates an event which is used by
  988. ToolManager to activate Exec objects or to toggle Dock objects. A
  989. description string has the following syntax:
  990.      [<class>] {[-][<qualifier>]} [-][upstroke] [<key code>]
  991.    All keywords are case insensitive.
  992.        @{b}class@{ub} describes the InputEvent class. This parameter is optional
  993. and if it is missing the default @{b}rawkey@{ub} is used. See @{"InputEvent classes" Link "InputEvent classes"}.
  994.    Qualifiers are "signals" that must be set or cleared by the time the
  995. Hot Key is activated; otherwise no event will be generated. For each
  996. qualifier that must be set you supply its keyword. All other qualifiers
  997. are expected to be cleared by default. If you want to ignore a
  998. qualifier, just set a @{b}-@{ub} before its keyword. See @{"Qualifiers" Link "Qualifiers"}.
  999.    Normally a Hot Key event is generated when a key is pressed. If the
  1000. event should be generated when the key is released, supply the keyword
  1001. @{b}upstroke@{ub}. When both press and release of the key should generate an
  1002. event, use @{b}-upstroke@{ub}.
  1003.    The key code is depending on the InputEvent class. See @{"Key codes" Link "Key codes"}.
  1004.  @{" InputEvent classes " Link "InputEvent classes"} 
  1005.  @{" Qualifiers " Link "Qualifiers"} 
  1006.  @{" Key codes " Link "Key codes"} 
  1007.  @{" Hot Key examples " Link "Hot Key examples"} 
  1008.    Note: Choose your hot keys @{i}carefully@{ui}, because Commodities has a high
  1009. priority in the InputEvent handler chain (i.e. will override existing
  1010. definitions).
  1011. @EndNode
  1012. @Node "InputEvent classes" "TM_English.guide/InputEvent classes"
  1013. @Next "Qualifiers"
  1014. @Toc "Hot Keys"
  1015. InputEvent classes
  1016. ==================
  1017.    Commodities supports most of the InputEvent classes that are
  1018. generated by the input.device. This section describes those classes
  1019. that are most useful for ToolManager Hot Keys.
  1020. @{b}rawkey@{ub}
  1021.      This is the default class and covers all keyboard events. For
  1022.      example @{b}rawkey a@{ub} or @{b}a@{ub} creates an event every time when the key "a"
  1023.      is pressed. You must specify a key code for this class. See @{"rawkey" Link "rawkey key codes"}.
  1024. @{b}rawmouse@{ub}
  1025.      This class describes all mouse button events. You must specify a
  1026.      key code for this class. See @{"rawmouse" Link "rawmouse key codes"}.
  1027. @{b}diskinserted@{ub}
  1028.      Events of this class are generated when a disk is inserted in a
  1029.      drive. This class has no key codes.
  1030. @{b}diskremoved@{ub}
  1031.      Events of this class are generated when a disk is removed from a
  1032.      drive. This class has no key codes.
  1033. @EndNode
  1034. @Node "Qualifiers" "TM_English.guide/Qualifiers"
  1035. @Next "Key codes"
  1036. @Prev "InputEvent classes"
  1037. @Toc "Hot Keys"
  1038. Qualifiers
  1039. ==========
  1040.    Some keyword synonyms were added to Commodities V38. These are
  1041. marked with an @{b}*@{ub}.
  1042. @{b}lshift@{ub}, @{b}left_shift@{ub} *
  1043.      Left shift key.
  1044. @{b}rshift@{ub}, @{b}right_shift@{ub} *
  1045.      Right shift key.
  1046. @{b}shift@{ub}
  1047.      Either shift key.
  1048. @{b}capslock@{ub}, @{b}caps_lock@{ub} *
  1049.      Caps lock key.
  1050. @{b}caps@{ub}
  1051.      Either shift key or caps lock key.
  1052. @{b}control@{ub}, @{b}ctrl@{ub} *
  1053.      Control key.
  1054. @{b}lalt@{ub}, @{b}left_alt@{ub} *
  1055.      Left alt key.
  1056. @{b}ralt@{ub}, @{b}right_alt@{ub} *
  1057.      Right alt key.
  1058. @{b}alt@{ub}
  1059.      Either alt key.
  1060. @{b}lcommand@{ub}, @{b}lamiga@{ub} *, @{b}left_amiga@{ub} *, @{b}left_command@{ub} *
  1061.      Left Amiga/Command key.
  1062. @{b}rcommand@{ub}, @{b}ramiga@{ub} *, @{b}right_amiga@{ub} *, @{b}right_command@{ub} *
  1063.      Right Amiga/Command key.
  1064. @{b}numericpad@{ub}, @{b}numpad@{ub} *, @{b}num_pad@{ub} *, @{b}numeric_pad@{ub} *
  1065.      This keyword @{i}must@{ui} be used for any key on the numeric pad.
  1066. @{b}leftbutton@{ub}, @{b}lbutton@{ub} *, @{b}left_button@{ub} *
  1067.      Left mouse button. See note below.
  1068. @{b}midbutton@{ub}, @{b}mbutton@{ub} *, @{b}middlebutton@{ub} *, @{b}middle_button@{ub} *
  1069.      Middle mouse button. See note below.
  1070. @{b}rbutton@{ub}, @{b}rightbutton@{ub} *, @{b}right_button@{ub} *
  1071.      Right mouse button. See note below.
  1072. @{b}repeat@{ub}
  1073.      This qualifier is set when the keyboard repeat is active. Only
  1074.      useful for InputEvent class @{b}rawkey@{ub}.
  1075.    Note: Commodities V37 has a bug which prevents the use of @{b}leftbutton@{ub},
  1076. @{b}midbutton@{ub} and @{b}rbutton@{ub} as qualifiers. This bug is fixed in V38.
  1077. @EndNode
  1078. @Node "Key codes" "TM_English.guide/Key codes"
  1079. @Next "Hot Key examples"
  1080. @Prev "Qualifiers"
  1081. @Toc "Hot Keys"
  1082. Key codes
  1083. =========
  1084.    Each InputEvent class has its own key codes:
  1085.  @{" rawkey " Link "rawkey key codes"}                 
  1086.  @{" rawmouse " Link "rawmouse key codes"} 
  1087. @EndNode
  1088. @Node "rawkey key codes" "TM_English.guide/rawkey key codes"
  1089. @Next "rawmouse key codes"
  1090. @Toc "Key codes"
  1091. Key codes for InputEvent class `rawkey'
  1092. ---------------------------------------
  1093.    Some keywords and synonyms were added to Commodities V38. These are
  1094. marked with an @{b}*@{ub}.
  1095. @{b}a@{ub}-@{b}z@{ub}, @{b}0@{ub}-@{b}9@{ub}, ...
  1096.      ASCII characters.
  1097. @{b}f1@{ub}, @{b}f2@{ub}, ..., @{b}f10@{ub}, @{b}f11@{ub} *, @{b}f12@{ub} *
  1098.      Function keys.
  1099. @{b}up@{ub}, @{b}cursor_up@{ub} *, @{b}down@{ub}, @{b}cursor_down@{ub} *
  1100. @{b}left@{ub}, @{b}cursor_left@{ub} *, @{b}right@{ub}, @{b}cursor_right@{ub} *
  1101.      Cursor keys.
  1102. @{b}esc@{ub}, @{b}escape@{ub} *, @{b}backspace@{ub}, @{b}del@{ub}, @{b}help@{ub}
  1103. @{b}tab@{ub}, @{b}comma@{ub}, @{b}return@{ub}, @{b}space@{ub}, @{b}spacebar@{ub} *
  1104.      Special keys.
  1105. @{b}enter@{ub}, @{b}insert@{ub} *, @{b}delete@{ub} *
  1106. @{b}page_up@{ub} *, @{b}page_down@{ub} *, @{b}home@{ub} *, @{b}end@{ub} *
  1107.      Numeric Pad keys. Each of these key codes @{i}must@{ui} be used with the
  1108.      @{b}numericpad@{ub} qualifier keyword!
  1109. @EndNode
  1110. @Node "rawmouse key codes" "TM_English.guide/rawmouse key codes"
  1111. @Prev "rawkey key codes"
  1112. @Toc "Key codes"
  1113. Key codes for InputEvent class `rawmouse'
  1114. -----------------------------------------
  1115.    These keywords were added to Commodities V38. They are not available
  1116. in V37.
  1117. @{b}mouse_leftpress@{ub}
  1118.      Press left mouse button.
  1119. @{b}mouse_middlepress@{ub}
  1120.      Press middle mouse button.
  1121. @{b}mouse_rightpress@{ub}
  1122.      Press right mouse button.
  1123.    Note: To use one of these key codes, you must also set the
  1124. corresponding qualifier keyword, e.g.
  1125.      rawmouse leftbutton mouse_leftpress
  1126. @EndNode
  1127. @Node "Hot Key examples" "TM_English.guide/Hot Key examples"
  1128. @Prev "Key codes"
  1129. @Toc "Hot Keys"
  1130. Examples for Hot Keys
  1131. =====================
  1132. @{b}ralt t@{ub}
  1133.      Hold right Alt key and press "t"
  1134. @{b}ralt lalt t@{ub}
  1135.      Hold left @{i}and@{ui} right Alt key and press "t"
  1136. @{b}alt t@{ub}
  1137.      Hold either Alt key and press "t"
  1138. @{b}rcommand f2@{ub}
  1139.      Hold right Amiga key and press the second function key
  1140. @{b}numericpad enter@{ub}
  1141.      Press the Enter key on the numeric pad
  1142. @{b}rawmouse midbutton leftbutton mouse_leftpress@{ub}
  1143.      Hold middle mouse button and press the the left mouse button
  1144. @{b}diskinserted@{ub}
  1145.      Insert a disk in any drive.
  1146. @EndNode
  1147. @Node "Questions" "TM_English.guide/Questions"
  1148. @Next "History"
  1149. @Prev "Hot Keys"
  1150. @Toc "Main"
  1151. Most asked questions about ToolManager
  1152. **************************************
  1153.    Here are the answers to the most asked questions about ToolManager:
  1154.    - Why can't ToolManager create multiple "Tools" menus or sub-menus?
  1155.      Multiple menus or sub-menus are currently not supported by the
  1156.      system software. To create them, you have to @{i}hack@{ui} them into the
  1157.      system software, which can result in an unstable system. I don't
  1158.      want to produce unstable software, so I won't implement such a
  1159.      thing in ToolManager.
  1160.    - WB programs won't start, but all other exec types work fine.
  1161.      ToolManager relies on the program @{b}L:WBStart-Handler@{ub} to start WB
  1162.      programs. There are two reasons, why ToolManager can't execute
  1163.      this program:
  1164.         @{b}*@{ub} The file @{b}L:WBStart-Handler@{ub} doesn't exists. Please copy it
  1165.           from the distribution archive.
  1166.         @{b}*@{ub} The execute flag (e) isn't set on this file. Use the
  1167.           following command to set this flag: @{b}protect L:WBStart-Handler
  1168.           +e@{ub}
  1169.    - How can I create a horizontal dock window?
  1170.      Just set the number of columns to the number of entries in the
  1171.      dock object.
  1172.    - How can I create an output window for CLI programs?
  1173.      Output windows can be created by using the @{b}CON:@{ub} device. Use the
  1174.      following file name to create an auto-open window with a close
  1175.      gadget which doesn't close after the program has quit:
  1176.           CON:10/10/640/100/Output-Window/AUTO/CLOSE/WAIT
  1177.      The @{b}CON:@{ub} device has many options, please consult your AmigaDOS
  1178.      manual for further information.
  1179.    - How can I put the arguments in the middle of a CLI/Arexx command
  1180.      line?
  1181.      Normally all arguments are appended to the command line. To insert
  1182.      the arguments anywhere in the command line, ToolManager uses the
  1183.      same @{b}[]@{ub} syntax, which is used by the AmigaShell command @{b}alias@{ub}. So
  1184.      for example
  1185.           Dir [] all
  1186.      will insert all arguments before the keyword @{b}all@{ub}.
  1187.    - How can I clear a link from a complex object to a simple object?
  1188.      After pressing the "xxx Object" button just press the "OK" button
  1189.      @{i}without@{ui} selecting an object. This means that you choosed no
  1190.      object, and therefore the link will be cleared.
  1191.    - How can I create sub-docks?
  1192.      You must use Exec objects of the type Dock. Put such objects in
  1193.      the entries of your main dock and they will open/close the other
  1194.      docks.
  1195.    - ToolManager is dead after starting a Network command.
  1196.      There is currently a problem with the network software, which
  1197.      doesn't timeout local requests. So if your machine is called @{b}Host1@{ub}
  1198.      and you have an Exec object of the type Network with the command
  1199.      @{b}Object@Host1@{ub}, ToolManager will run into a dead-lock when you
  1200.      activate it. Please use only names of remote machines!
  1201. @EndNode
  1202. @Node "History" "TM_English.guide/History"
  1203. @Next "Credits"
  1204. @Prev "Questions"
  1205. @Toc "Main"
  1206. The History of ToolManager
  1207. **************************
  1208. 2.1, Release date 16.05.1993
  1209.         - New Exec object types: Dock, Hot Key, Network
  1210.         - New Dock object flags: Backdrop, Sticky
  1211.         - New object type: Access
  1212.         - Network support
  1213.         - Editor main window is now an AppWindow
  1214.         - Gadget keyboard shortcuts in the preferences editor
  1215.         - New tooltypes for the preferences editor
  1216.         - Several bug fixes
  1217.         - Enhanced documentation
  1218. 2.0, Release date 26.09.1992, Fish Disk #752
  1219.         - Complete new concept (object oriented)
  1220.         - (Almost) Complete rewrite
  1221.         - ToolManager is now split up into two parts
  1222.         - Main handler is now embedded into a shared library
  1223.         - Configuration is now handled by a Preferences program
  1224.         - Configuration file format has changed again :-) It is an IFF
  1225.           File now and resides in ENV:
  1226.         - Multiple Docks and multi-column Docks
  1227.         - Docks with new window design
  1228.         - Dock automatically detects largest image size
  1229.         - Sound support
  1230.         - Direct ARexx support for Exec objects
  1231.         - ToolManager can be used without the Workbench. If the
  1232.           Workbench isn't running, it won't use any App* features.
  1233.         - Locale support
  1234.         - Path from Workbench will be used for CLI tools
  1235.         - Seperate Handler Task for starting WB processes
  1236. 1.5, Release date 10.10.1991, Fish Disk #551
  1237.         - Status Window: New/Open/Append/Save As menu items for config
  1238.           file
  1239.         - Edit Window: File requesters for file string gadgets
  1240.         - Added a Dock Window (a la NeXT)
  1241.         - Added a DeleteTool
  1242.         - A list of all active HotKeys can be shown
  1243.         - Tools can be moved around in the list
  1244.         - Icon positioning in the edit window added
  1245.         - Name of the program icon can be set
  1246.         - CLI tools can have an output file and a path list
  1247.         - Uses UserShell for CLI tools
  1248.         - Maximum command line length for CLI tools is now 4096 Bytes
  1249.         - AppIcons without a name are supported now
  1250.         - Workbench screen will be moved to front if you pop up the
  1251.           Status window
  1252.         - Workbench screen can be moved to front before starting a tool
  1253.           via HotKey
  1254.         - TM will wait up to 20 seconds for the workbench.library
  1255.         - Added a DELAY switch which causes TM to wait <num> seconds
  1256.           before adding any App* stuff
  1257.         - renamed some tooltypes/parameters
  1258.         - some visual cues added
  1259.         - some internal changes
  1260. 1.4, Release date 09.07.1991, Fish Disk #527
  1261.         - Keyboard short cuts for tools
  1262.         - AppIcons for tools
  1263.         - Menu item can be switched off
  1264.         - Configuration file format completely changed (hopefully the
  1265.           last time)
  1266.         - CLI commandline parsing is now done by ReadArgs()
  1267.         - Status & edit window updated to new features
  1268.         - Safety check before program shutdown added
  1269.         - Menu item "Open TM Window" only appears if the program icon is
  1270.           disabled
  1271.         - WB startup method changed. Now supports project icons
  1272.         - several internal changes
  1273. 1.3, Release date 13.03.1991, Fish Disk #476
  1274.         - Now supports different configuration files
  1275.         - Format of the configuration file slightly changed
  1276.         - Tool definitions can be changed at runtime
  1277.         - Now supports CLI & Workbench startup method
  1278.         - Selected icons are passed as parameters to the tools
  1279.         - Now uses the startup icon as program icon if started from
  1280.           Workbench
  1281.         - The position of the icon can now be supplied in the
  1282.           configuration file
  1283.         - The program icon can now be disabled
  1284.         - New menu entry "Show TM Window"
  1285.         - Every new started ToolManager passes its startup parameters
  1286.           to the already running ToolManager process
  1287. 1.2, Release date 12.01.1991, Fish Disk #442
  1288.         - Status window changed to a no-GZZ & simple refresh type (this
  1289.           should save some bytes)
  1290.         - Status window remembers its last position
  1291.         - New status window gadget "Save Configuration": saves the
  1292.           actual tool list in the configuration file
  1293.         - Small bugs removed in the ListView gadget handling
  1294.         - Name of the icon hard-wired to "ToolManager"
  1295. 1.1, Release date 01.01.1991
  1296.         - Icons can be dropped on the status window
  1297.         - Status window contains a list of all tool names
  1298.         - Tools can be removed from the list
  1299. 1.0, Release date 04.11.1990
  1300.         - Initial release
  1301. @EndNode
  1302. @Node "Credits" "TM_English.guide/Credits"
  1303. @Next "Index"
  1304. @Prev "History"
  1305. @Toc "Main"
  1306. The author would like to thank...
  1307. *********************************
  1308.    ToolManager has gone through many major evolutionary phases since
  1309. its first implementation in mid-1990. This development would have been
  1310. impossible if I hadn't received the enormous feedback from various
  1311. ToolManager users. Many ideas & features resulted from this source...
  1312.    Therefore I would like to thank:
  1313. For Alpha/Beta testing, ideas & bug reports:
  1314.      Amiga section of our local computer club (Computerclub an der RWTH
  1315.      Aachen), Olaf 'Olsen' Barthel, Georg Hessmann (Gucky), Markus
  1316.      Illenseer (ill), Klaus Melchior, Rickard Olsson (Richie), Matthias
  1317.      Scheler (Tron), Ralph Schmidt (laire), Roger Westerlund (Budda),
  1318.      Juergen Weinelt, Brian Wright (SteveVai), Petra Zeidler
  1319.      (stargazer) and many others...
  1320. Matthew Dillon
  1321.      Without your @{i}excellent@{ui} C development system DICE and various other
  1322.      tools, ToolManager wouldn't exist!
  1323. For their excellent graphics work:
  1324.      Andreas Harrenberg, Georg Hessmann, Michael "Mick" Hohmann, Markus
  1325.      Illenseer, Oliver Koenen, Klaus Melchior, Rickard Olsson, Jan
  1326.      Peter, Matthias Scheler, Brian Wright
  1327. For the translations:
  1328.      Tomi Blinnikka (suomi), Jorn Halonen (norsk), Dr. Peter Kittel
  1329.      (deutsch), Jasper Kehlet (dansk), Klaus Melchior (eifel), Rickard
  1330.      Olsson (svenska), Rullier Pascal (fran
  1331. ais), Marc Schaefer
  1332.      (fran
  1333. ais), Tor Rune Skoglund (norsk), Reinhard Spisser
  1334.      (italiano), Andrea Suatoni (italiano)
  1335. All gals & guys at West Chester:
  1336.      For developing the Amiga and its superb operating system.
  1337. All users who sent me money:
  1338.      I didn't ask for it in the 1.X releases, but it's nice to see when
  1339.      someone appreciates my work.
  1340. All users who sent me a note:
  1341.      I really enjoyed reading your letters!
  1342. and all I forgot to mention...
  1343. @EndNode
  1344. @Node "Index" "TM_English.guide/Index"
  1345. @Prev "Credits"
  1346. @Toc "Main"
  1347. Index
  1348. *****
  1349. @Index "Index"
  1350.  @{" TeX " Link "Docs"}                                  Docs
  1351.  @{" Access objects " Link "Access"}                       Access
  1352.  @{" Address " Link "Authors address"}                              Authors address
  1353.  @{" AmigaGuide " Link "Docs"}                           Docs
  1354.  @{" Answers " Link "Questions"}                              Questions
  1355.  @{" ARexx scripts " Link "Scripts"}                        Scripts
  1356.  @{" ASCII documentation " Link "Docs"}                  Docs
  1357.  @{" Bug reports " Link "Authors address"}                          Authors address
  1358.  @{" Catalog files " Link "Locale"}                        Locale
  1359.  @{" CLI Arguments " Link "CLI Arguments"}                        CLI Arguments
  1360.  @{" Comments " Link "Authors address"}                             Authors address
  1361.  @{" Compiler support " Link "Programmers"}                     Programmers
  1362.  @{" Concepts " Link "Concepts"}                             Concepts
  1363.  @{" Configuration " Link "Preferences"}                        Preferences
  1364.  @{" Contributed images " Link "Graphics"}                   Graphics
  1365.  @{" Copyright " Link "Copyright"}                            Copyright
  1366.  @{" Credits " Link "Credits"}                              Credits
  1367.  @{" DeleteTool " Link "Goodies"}                           Goodies
  1368.  @{" Diskinserted " Link "InputEvent classes"}                         InputEvent classes
  1369.  @{" Diskremoved " Link "InputEvent classes"}                          InputEvent classes
  1370.  @{" Distribution " Link "Copyright"}                         Copyright
  1371.  @{" Distribution files " Link "Distribution files"}                   Distribution files
  1372.  @{" Dock objects " Link "Dock"}                         Dock
  1373.  @{" Docs directory " Link "Docs"}                       Docs
  1374.  @{" Documentation " Link "Docs"}                        Docs
  1375.  @{" Donations " Link "Authors address"}                            Authors address
  1376.  @{" E-Mail " Link "Authors address"}                               Authors address
  1377.  @{" Example " Link "Tutorial"}                              Tutorial
  1378.  @{" Example images " Link "Graphics"}                       Graphics
  1379.  @{" Examples for Hot Keys " Link "Hot Key examples"}                Hot Key examples
  1380.  @{" Exec objects " Link "Exec"}                         Exec
  1381.  @{" Fast installation " Link "Quick installation"}                    Quick installation
  1382.  @{" GetPubName " Link "Goodies"}                           Goodies
  1383.  @{" GiftWare " Link "Important"}                             Important
  1384.  @{" Goodies directory " Link "Goodies"}                    Goodies
  1385.  @{" Graphics directory " Link "Graphics"}                   Graphics
  1386.  @{" Guided tour " Link "Tutorial"}                          Tutorial
  1387.  @{" History " Link "History"}                              History
  1388.  @{" Hot Keys " Link "Hot Keys"}                             Hot Keys
  1389.  @{" Icon objects " Link "Icon"}                         Icon
  1390.  @{" Image objects " Link "Image"}                        Image
  1391.  @{" Important notes " Link "Important"}                      Important
  1392.  @{" InputEvent classes " Link "InputEvent classes"}                   InputEvent classes
  1393.  @{" Installation (quick) " Link "Quick installation"}                 Quick installation
  1394.  @{" InterNet address " Link "Authors address"}                     Authors address
  1395.  @{" Introduction to Hot Keys " Link "Hot Keys"}             Hot Keys
  1396.  @{" Introduction to ToolManager " Link "Introduction"}          Introduction
  1397.  @{" Introduction to ToolManager objects " Link "Concepts"}  Concepts
  1398.  @{" Key codes for rawkey " Link "rawkey key codes"}                 rawkey key codes
  1399.  @{" Key codes for rawmouse " Link "rawmouse key codes"}               rawmouse key codes
  1400.  @{" L directory " Link "L"}                          L
  1401.  @{" Language files " Link "Locale"}                       Locale
  1402.  @{" Languages " Link "Locale"}                            Locale
  1403.  @{" Legal stuff " Link "Copyright"}                          Copyright
  1404.  @{" Library documentation " Link "Docs"}                Docs
  1405.  @{" Library interface " Link "Library"}                    Library
  1406.  @{" Libs directory " Link "Libs"}                       Libs
  1407.  @{" List: rawkey key codes " Link "rawkey key codes"}               rawkey key codes
  1408.  @{" List: rawmouse key codes " Link "rawmouse key codes"}             rawmouse key codes
  1409.  @{" List: Qualifiers " Link "Qualifiers"}                     Qualifiers
  1410.  @{" Locale directory " Link "Locale"}                     Locale
  1411.  @{" Localization " Link "Locale"}                         Locale
  1412.  @{" Menu objects " Link "Menu"}                         Menu
  1413.  @{" Objects " Link "Objects"}                              Objects
  1414.  @{" Permissions " Link "Copyright"}                          Copyright
  1415.  @{" Postal address " Link "Authors address"}                       Authors address
  1416.  @{" Preferences editor " Link "Preferences"}                   Preferences
  1417.  @{" Prefs directory " Link "Prefs"}                      Prefs
  1418.  @{" Printed documentation " Link "Docs"}                Docs
  1419.  @{" Probibitions " Link "Copyright"}                         Copyright
  1420.  @{" Program concepts " Link "Concepts"}                     Concepts
  1421.  @{" Programm versions " Link "History"}                    History
  1422.  @{" Programmers directory " Link "Programmers"}                Programmers
  1423.  @{" Qualifiers " Link "Qualifiers"}                           Qualifiers
  1424.  @{" Questions " Link "Questions"}                            Questions
  1425.  @{" Quick installation " Link "Quick installation"}                   Quick installation
  1426.  @{" Rawkey " Link "InputEvent classes"}                               InputEvent classes
  1427.  @{" Rawmouse " Link "InputEvent classes"}                             InputEvent classes
  1428.  @{" Reference: Distribution files " Link "Distribution files"}        Distribution files
  1429.  @{" Reference: Hot Keys " Link "Hot Keys"}                  Hot Keys
  1430.  @{" Reference: Library interface " Link "Library"}         Library
  1431.  @{" Reference: Preferences editor " Link "Preferences"}        Preferences
  1432.  @{" Reference: ToolManager objects " Link "Objects"}       Objects
  1433.  @{" Scripts directory " Link "Scripts"}                    Scripts
  1434.  @{" Shared library interface " Link "Library"}             Library
  1435.  @{" Shell scripts " Link "Scripts"}                        Scripts
  1436.  @{" Sound objects " Link "Sound"}                        Sound
  1437.  @{" Sound player " Link "Goodies"}                         Goodies
  1438.  @{" Source code " Link "Source"}                          Source
  1439.  @{" Source directory " Link "Source"}                     Source
  1440.  @{" Texinfo " Link "Docs"}                              Docs
  1441.  @{" Thanks " Link "Credits"}                               Credits
  1442.  @{" ToolManager objects " Link "Objects"}                  Objects
  1443.  @{" ToolManager shared library interface " Link "Library"} Library
  1444.  @{" Tooltypes " Link "Tooltypes"}                            Tooltypes
  1445.  @{" Translations " Link "Locale"}                         Locale
  1446.  @{" Translators " Link "Source"}                          Source
  1447.  @{" Tutorial " Link "Tutorial"}                             Tutorial
  1448.  @{" UPD " Link "Goodies"}                                  Goodies
  1449.  @{" V38 (and higher) features " Link "Important"}            Important
  1450.  @{" Versions " Link "History"}                             History
  1451.  @{" WBStart 1.2 " Link "L"}                          L
  1452.  @{" WBStart-Handler " Link "L"}                      L
  1453.  @{" WBStartup directory " Link "WBStartup"}                  WBStartup
  1454. @EndNode
  1455.